thermo18

---

Thermo 18 Click

Thermo 18 Click demo application is developed using the NECTO Studio, ensuring compatibility with mikroSDK's open-source libraries and tools. Designed for plug-and-play implementation and testing, the demo is fully compatible with all development, starter, and mikromedia boards featuring a mikroBUS™ socket.

---

Click Library

• Author : Luka FIlipovic
• Date : Aug 2021.
• Type : I2C type

Software Support

Example Description

The example application showcases ability of device to read temperature and detect and assert interrupt on undertemperature or overtemperature thresholds.

Example Libraries

• MikroSDK.Board
• MikroSDK.Log
• Click.Thermo18

Example Key Functions

• thermo18_cfg_setup Config Object Initialization function.

  void thermo18_cfg_setup ( thermo18_cfg_t *cfg );

• thermo18_init Initialization function.

  err_t thermo18_init ( thermo18_t *ctx, thermo18_cfg_t *cfg );

• thermo18_default_cfg Click Default Configuration function.

  err_t thermo18_default_cfg ( thermo18_t *ctx );

• thermo18_read_temperature Reads and calculates temperature value.

  err_t thermo18_read_temperature ( thermo18_t *ctx, float *temperature )

• thermo18_set_temperature_threshold Sets temperature threshold.

  err_t thermo18_set_temperature_threshold ( thermo18_t *ctx, uint8_t threshold_reg, float threshold_limit );

• thermo18_reset Resets device.

  err_t thermo18_reset ( thermo18_t *ctx );

Application Init

Initialization of communication modules and interrupt pin. Reads device ID to check comunication. Then resets device, and sets undertemperature and overtemperature thresholds on 24 and 30 degrees Celsius. In the end enables OneShot temperature conversion.

void application_init ( void )
{
    log_cfg_t log_cfg;  
    thermo18_cfg_t thermo18_cfg;  

    LOG_MAP_USB_UART( log_cfg );
    log_init( &logger, &log_cfg );
    log_info( &logger, " Application Init " );
 
    // Click initialization.
    thermo18_cfg_setup( &thermo18_cfg );
    THERMO18_MAP_MIKROBUS( thermo18_cfg, MIKROBUS_1 );
    err_t init_flag = thermo18_init( &thermo18, &thermo18_cfg );
    if ( I2C_MASTER_ERROR == init_flag )
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
 
    uint8_t temp_data = 0;
    thermo18_generic_read( &thermo18, THERMO18_REG_DEVICE_ID, &temp_data );
    log_printf( &logger, " > ID: 0x%.2X\r\n", ( uint16_t )temp_data );
 
    if ( THERMO18_DEVICE_ID != temp_data )
    {
        log_error( &logger, " Device ID. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
 
    if ( thermo18_default_cfg ( &thermo18 ) )
    {
        log_error( &logger, " Default configuration. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
 
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    //One shot reading
    thermo18_generic_write( &thermo18, THERMO18_REG_CTRL, THERMO18_CONTROL_ONESHOT_ENABLED );
 
    log_info( &logger, " Application Task " );
}

Application Task

Checks status to see if the temperature conversion is finished. When it's finished reads and logs calculated temperature data. Then checks if status is asserted for threshold detection, and logs if detected. In the end re-enables OneShot conversion.

void application_task ( void ) 
{
    uint8_t status;
    thermo18_generic_read( &thermo18, THERMO18_REG_STATUS, &status );
    //Check if data is ready
    if ( THERMO18_STATUS_DATA_READY == ( status & THERMO18_STATUS_DATA_BUSY ) )
    {
        //Temperature reading
        float temp = 0.0;
        thermo18_read_temperature( &thermo18, &temp );
        log_printf( &logger, " > Temperature[degC]: %.2f\r\n", temp );
        //Check threshold
        if ( 0 != status )
        {
            if ( THERMO18_STATUS_OVERTEMPERATURE == status )
            {
                log_info( &logger, " Overtemperature Threshold detected." );
            }
            else if ( THERMO18_STATUS_UNDERTEMPERATURE == status )
            {
                log_info( &logger, " Undertemperature Threshold detected." );
            }
        }
        //Re-Enable One shot reading
        thermo18_generic_write( &thermo18, THERMO18_REG_CTRL, THERMO18_CONTROL_ONESHOT_ENABLED );
    }
 
    Delay_ms ( 300 );
}

Application Output

This Click board can be interfaced and monitored in two ways:

• Application Output - Use the "Application Output" window in Debug mode for real-time data monitoring. Set it up properly by following this tutorial.
• UART Terminal - Monitor data via the UART Terminal using a USB to UART converter. For detailed instructions, check out this tutorial.

Additional Notes and Information

The complete application code and a ready-to-use project are available through the NECTO Studio Package Manager for direct installation in the NECTO Studio. The application code can also be found on the MIKROE GitHub account.

---